home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Magnum One
/
Magnum One (Mid-American Digital) (Disc Manufacturing).iso
/
d2
/
zce10.arc
/
ZCE.DOC
< prev
next >
Wrap
Text File
|
1991-04-06
|
30KB
|
871 lines
Zip Comment Editor and Zip Directory
=----------------------------------=
Users's Guide
Version 1.0
March, 26, 1991
Copyright (C) 1990, 91
by
Michael D. Boling
All Rights Reserved
COPYRIGHT NOTICE
ZCE Version 1.0
ZD Version 1.0
Copyright (c) 1990, 91 by Michael D. Boling
All Rights Reserved
Zip Comment Editor (ZCE) and companion program Zip Directory (ZD)
allow editing and viewing of ZIP file Comments.
ZCE and ZD have been released as shareware. This means the
version you have is fully functional. It also means that if
decide to use ZCE or ZD you are obligated to pay a licensing fee.
ZCE and ZD are copyrighted and may be distributed only under the
following conditions:
No fee of over $10.00 may be charged for distribution. This
restriction applies only to physical copies and is not meant to
prevent distribution by telecommunication services.
All ZCE files must be distributed together in original, unaltered
form. This includes FILES.LST, ZCE.DOC, ZCE.NEW, and
REGISTER.TXT.
You use these programs at your own risk. It has been tested by me
on my own computer, but I will not assume any responsibility for
any problems which ZCE or ZD may cause you. If you do encounter a
problem, please let me know about it, and I will do my best to
verify and repair the error.
LIMITED WARRANTY
THE PROGRAMS CONTAINED IN THIS PACKAGE ARE PROVIDED "AS IS"
WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED,
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE
RISK RELATED TO THE QUALITY AND PERFORMANCE OF THE PROGRAMS IS ON
YOU. IN THE EVENT THERE IS ANY DEFECT, YOU ASSUME THE ENTIRE COST
OF ALL NECESSARY SERVICING, REPAIR, OR CORRECTION. SOME STATES DO
NOT ALLOW THE EXCLUSION OF IMPLIED WARRANTIES, SO THE ABOVE
EXCLUSION MAY NOT APPLY TO YOU. THIS WARRANTY GIVES YOU SPECIFIC
LEGAL RIGHTS WHICH VARY FROM STATE TO STATE.
It is expected that if you find ZCE and ZD useful, you will
register your copy. Registration entitles you to receive the
latest version of ZCE and ZD without trailing banners.
Table of Contents
What are ZCE and ZD? . . . . . . . . . . . . . . 1
ZCE Features . . . . . . . . . . . . . . . . . . 1
ZD Features . . . . . . . . . . . . . . . . . . . 1
Limitations of ZCE and ZD . . . . . . . . . . . . 1
System Requirements . . . . . . . . . . . . . . . 2
Using ZCE <Zip Comment Editor> . . . . . . . . . 2
Example ZCE Screen . . . . . . . . . . . . . . . 3
ZCE Editing Keys . . . . . . . . . . . . . . . . 4
ZCE Commands . . . . . . . . . . . . . . . . . . 4
F1 = On Line Help Window Functions . . . . . . . 4
Mouse Help Window Functions . . . . . . . . . . . 4
F2 = Re-Read Zip Comments . . . . . . . . . . . . 5
F3 = Write Zip Comments . . . . . . . . . . . . . 5
F4 = Enter New FileSpec and Read Zip Comments . . 5
F5 = Copy Comment from Another File . . . . . . . 5
F6 = Import Zip Comments from a File . . . . . . 6
File Import Functions . . . . . . . . . . . . . . 6
Comments Filename . . . . . . . . . . . . . . . . 6
Starting Comment Column . . . . . . . . . . . . . 6
Edit/Auto . . . . . . . . . . . . . . . . . . . . 6
Import Special Editing Commands . . . . . . . . . 7
F7 = Volume Label . . . . . . . . . . . . . . . . 7
F8 = Shell to Dos <See Warning> . . . . . . . . . 7
F9 = Future . . . . . . . . . . . . . . . . . . . 8
F10 = Exit ZCE . . . . . . . . . . . . . . . . . 8
Using ZD <Zip Directory> . . . . . . . . . . . . 9
ZD Command line syntax . . . . . . . . . . . . . 9
Display Options . . . . . . . . . . . . . . . . . 9
Color Options . . . . . . . . . . . . . . . . . . 9
Sorting Options . . . . . . . . . . . . . . . . . 10
Pause Control Options . . . . . . . . . . . . . . 10
Command Line Examples . . . . . . . . . . . . . . 10
ZCE and ZD Registration Form . . . . . . . . . . 11
ACKNOWLEDGEMENTS . . . . . . . . . . . . . . . . 12
Future Versions . . . . . . . . . . . . . . . . . 12
1.1 - What are ZCE and ZD? Page 1
---------------------------------------------------------------------------
1.1 What are ZCE and ZD?
Have you ever looked into a directory or a disk and wondered what
was in those Zip files??? I have on many occasions. That's why I
created ZCE and ZD. (1)PKZIP was just to time consuming when
adding zip comments to many zip files.
ZCE and companion program ZD allow easy editing and displaying of
Zip comments. Once Zip comments are added to Zip files, you will
never have to unzip them to know what programs are inside. You
won't have to unzip them and look for the infamous readme.doc or
.doc file to find out what the programs do. I found this very
time consuming and usually found that this was not the program I
was looking for. Some disk cataloging programs can automatically
read Zip comments and will add them to your reports. ZD will
quickly display any comments found in your Zip files.
(1)PKZIP Is a registered trademark of PKWARE Inc.
1.2 ZCE Features
Display and edit zip comments
Save comments into zip files
On line help
Re-read zip comments
Copy comment from another file
Import comments from external file
Modify floppy volume labels
Shell to dos
1.3 ZD Features
Companion program to ZCE
Quickly display file names and zip comments
Color options
File sorting options
1.4 Limitations of ZCE and ZD
Current limit is set to 500 files in any one directory.
---------------------------------------------------------------------------
ZCE & ZD Users' Manual 1.4 - Limitations of ZCE and ZD
Page 2 ZCE & ZD Users' Manual
---------------------------------------------------------------------------
1.5 System Requirements
ZCE and ZD have been designed to work properly on the (*)IBM-PC,
IBM-XT, IBM-AT, PS/2, and any close compatible. ZCE and ZD
require about 256K of ram to execute. ZCE and ZD require PC/MS
DOS version 2.1 or later.
* IBM-PC, IBM-XT, IBM-AT are trademarks of International Business
Machines Corporation, Boca Roton, Florida.
1.6 Using ZCE <Zip Comment Editor>
ZCE
By itself on the command line will search the current directory
for *.zip and display one screen of filenames and comments sorted
by filename.
ZCE FOO*
ZCE will search for ZCE*.ZIP in the current directory
ZCE A:
ZCE will search drive a: for *.zip
ZCE C:\DOS
ZCE will search for a directory called DOS. If the directory DOS
exists then ZCE will search for C:\DOS\*.ZIP. If the directory
does not exist then ZCE will look for the filename of DOS.
Once ZCE determines that the input filename specification is legal
ZCE will display a window showing the zip files being searched for
comments.
Escape may be pressed to interrupt ZCE while reading comments. A
query box will be displayed to continue reading zip comments.
Valid responses are:
Y/N for Yes or No Arrow keys move highlighted response, Enter
selects Left mouse button click on item if an mouse is detected.
ZCE will display an error message if the command line arguments
are invalid or if there is a problems opening or reading the files
found. The error will indicate the problem.
---------------------------------------------------------------------------
1.6 - Using ZCE <Zip Comment Editor> ZCE & ZD Users' Manual
1.7 - Example ZCE Screen Page 3
---------------------------------------------------------------------------
1.7 Example ZCE Screen
disk space volume label
| |
version # | drive | monitor
| | | | |
|-------------------------------------------------------------------|
| Zip Comment Editor, Version 1.0 350K A: MY_Disk5 EGA |
|-------------------------------------------------------------------|
|DOCUMENT.ZIP|This is a set of documents to be reviewed later. |
|FILENAME.ZIP|This is a zip COMMENT........................... |
|OTHER.ZIP |$$$ Could not find zipfile comment, may be bad zipfile|
| | |
| | |
| | |
| | |
| | |
| | |
|-------------------------------------------------------------------|
|F1=Help F2=Read F3=Write F4=Filespec F5=Copy F6=Import F7=Vol......|
|-------------------------------------------------------------------|
ZCE will now either pop a window of zip file names being read or
display an error message if there is a problem. ZCE will display
in color or monochrome depending upon the type of graphics card
detected.
All zip files detected will be displayed on the left side with zip
comments on the right. The comment will have all control
characters removed and truncated to 65 characters. If you want to
preserve any zip comment, simply do not edit the comment. ZCE
will only update modified comments.
If ZCE had trouble locating the zip comment the message "$$$ Could
not find zipfile comment, may be bad zipfile" will be displayed as
the comment. It may be edited but not saved. Either the zip file
is corrupted or the zip comment is very large. Usually deleting
the zip comment will allow ZCE to read it correctly. DO NOT DO
THIS IN THE SHELL unless you execute the re-read zip comments
comment when you return to ZCE!!! See warning in the Shell to Dos
section.
A Function key list will be displayed on the bottom line of the
screen.
---------------------------------------------------------------------------
ZCE & ZD Users' Manual 1.7 - Example ZCE Screen
Page 4 ZCE & ZD Users' Manual
---------------------------------------------------------------------------
1.8 ZCE Editing Keys
Insert Toggles the insert mode and over-type mode.
Delete Delete character at cursor.
Backspace Destructive backspace.
Left Arrow Move the cursor to the left.
Right Arrow Move the cursor to the right.
Home Move the cursor to the beginning of the field.
End Move the cursor to the end of the field.
Ctrl-Home Move cursor to the start and erase the field.
Ctrl-End Erase from the cursor to the end of the field.
Ctrl-BkSpace Erase from the cursor to the start of the field.
Escape Returns comment to its original text.
Alt-Home Scroll to top comment.
Alt-End Scroll to bottom comment.
1.9 ZCE Commands
1.9.1 F1 = On Line Help Window Functions
F1 Help
Home Goes to the beginning of the help page.
End Goes to the end of the help page.
PgDn Moves to next help page.
PgUp Moves to previous help page.
Escape Exits the help screen.
1.9.1.1 Mouse Help Window Functions
Previous Page Click mouse button between up arrow and scroll bar
position marker.
Next Page Click mouse button between down arrow and scroll
bar position marker.
Move Pointer The position marker in the scroll bar approximates
the position within the help array. To move to
another relative position, place mouse cursor on
scroll bar position marker, hold left mouse button,
move to desired area on scroll bar, and release
mouse button.
First Page Click mouse on up arrow.
Last Page Click mouse on down arrow.
---------------------------------------------------------------------------
1.9 - ZCE Commands ZCE & ZD Users' Manual
1.9 - ZCE Commands Page 5
---------------------------------------------------------------------------
Exit Move mouse cursor to the top-left corner of the
window and press the left mouse button.
scroll bar scroll bar approximates the position within the
help array. To move to array. To move to another
relative position, place mouse place mouse cursor
on scroll bar position marker, hold left marker,
hold left mouse button, move to desired area on
desired area on scroll bar, and release mouse
button.
1.9.2 F2 = Re-Read Zip Comments
Causes ZCE to read Comments from files with ZIP extensions using
the current drive, path and file specifications.
1.9.3 F3 = Write Zip Comments
Writes any modified comment to the file from the drive and path it
was read from. Any errors encountered will cause ZCE to display a
message of the problem. ZCE verifies all data writes. ZCE will
not change file dates or times. ZCE will then ask if you want to
exit. See F10 for instructions.
1.9.4 F4 = Enter New FileSpec and Read Zip Comments
An input window will pop up requesting a new file specification.
ZCE will then check this entry and give errors if the input could
not be parsed or no files could be found. Wildcard characters are
accepted. * or *.zip or c:\dos\app? are all valid examples. ZCE
will display an error if an invalid drive, path or file
specification are entered. Entering nothing or pressing the
escape key will exit ZCE. The same rules apply as the command
line file specification when starting ZCE.
1.9.5 F5 = Copy Comment from Another File
If more than one file comment is displayed then ZCE will pop up a
window of all current comments which may be chosen for the current
file comment. Use the arrow keys and enter to select. Escape
will abort this operation. Home/End keys will move highlight bar
to the first/last items in the list. If a mouse is detected the
mouse pointer will be displayed. Move the mouse pointer to an
item and select using the left button.
---------------------------------------------------------------------------
ZCE & ZD Users' Manual 1.9 - ZCE Commands
Page 6 ZCE & ZD Users' Manual
---------------------------------------------------------------------------
1.9.6 F6 = Import Zip Comments from a File
ZCE will search the current directory and all directories in the
current Dos Path for the file ZCE.SET. If not found a message is
displayed and defaults are created.
Filename for Settings: ZCE.SET
Comments Filename: BBS.LOG Starting
Comment Column: 30
Comment Search, Edit/Auto: E
1.9.6.1 File Import Functions
F1 Pop up help window
F8 Save Settings file
F9 Read Settings file
F10 Start Import
Esc Abort Import function
Filename for Settings:
This is the filename to store the current import settings. If
this file is not found in the current directory or in the current
DOS path, ZCE will display an error message.
1.9.6.2 Comments Filename
This is the filename of the file containing the comments to
import.
1.9.6.3 Starting Comment Column
This the position where ZCE should start reading the comment if
the filename is found in the comments filename. This option is
only used in AUTO (A) mode.
1.9.6.4 Edit/Auto
This is the import type. E for EDIT and A for Automatic. ZCE can
read single line comments from a file in AUTOMATIC mode or up to
240 characters into an line editor in EDIT mode. AUTOMATIC mode
searches the Comments file for a line containing the filename
portion like DOCS in DOCS.ZIP and the string ZIP. This allows the
ZCE to find comments in all type of BBS (Bulletin Board System)
file listings. Just remember that the first time ZCE encounters
the line that matches the test it will use the string on the same
---------------------------------------------------------------------------
1.9 - ZCE Commands ZCE & ZD Users' Manual
1.9 - ZCE Commands Page 7
---------------------------------------------------------------------------
line after the Starting Comment Column setting. Also remember
this may not be the correct comment. Make sure you check the
comments after ZCE is finished. In EDIT more (default) ZCE will
pop up an line editor with three lines. Actually ZCE takes the
line that the filename is found and the next 2 lines and appends
them without spaces between the major strings. Sounds complicated
but is really isn't. You can now edit the comment to your liking.
Just remember that the finished comment must be no longer than 65
characters long. ZCE will truncate longer comments.
1.9.6.5 Import Special Editing Commands
All editing commands are the same as the main ZCE window with
addition of the following:
F1 Help, Pop up help window
Esc Skip, Skips the current comment and will keep the
current filename on the search list.
Enter Accept, Truncates the current comment to 65
characters and removes the filename from the search
list.
Ctrl-Enter
Abort, Terminate Import function. ZCE will ask if
you really want to Abort. ZCE will still use all
comments found even if Abort is selected.
Tab Restore, Tab will Restore the comment to it's original
form just in case you made a mistake.
1.9.7 F7 = Volume Label
If the current or selected drive is A: or B: then ZCE will pop up
an input window for the new volume label. Only 11 characters will
be allowed. ZCE will only allow characters that are valid for
volume labels.
1.9.8 F8 = Shell to Dos <See Warning>
Spawns another Command.Com leaving ZCE in memory. About 200K is
used by ZCE. If the system crashes or is re-booted all editing of
comments will be lost unless saved.
The prompt is modified to remind you to type EXIT to return to
---------------------------------------------------------------------------
ZCE & ZD Users' Manual 1.9 - ZCE Commands
Page 8 ZCE & ZD Users' Manual
---------------------------------------------------------------------------
ZCE.
Enter 'EXIT' to Return to ZCE
C:\QB\ZCE>
WARNING!!!!! WARNING!!!!! WARNING!!!!! WARNING!!!!!
If you Shell to Dos and modify a Zip file in any way, the comment
address will be altered and ZCE will write data in the incorrect
location in the file. This will corrupt the Zip file. When ever
you return to ZCE from the shell always re-read the Zip file
comments using the <F2> key. This will update comment positions
to ZCE and allow correct comment update. The best advise is DO
NOT USE PKZIP while in the ZCE shell.
1.9.9 F9 = Future
This function key is not currently in use.
1.9.10 F10 = Exit ZCE
A message will be displayed asking if you would like to exit ZCE.
Default is NO. Arrow keys move between No and YES. The enter key
will select. Y or N will also select. If you have a mouse the
left button may be used to click on the Y or N.
---------------------------------------------------------------------------
1.9 - ZCE Commands ZCE & ZD Users' Manual
1.10 - Using ZD <Zip Directory> Page 9
---------------------------------------------------------------------------
1.10 Using ZD <Zip Directory>
1.10.1 ZD Command line syntax
ZD Drive:\Path\Filenames> [/options]
Drive must be a Valid Dos Drive, i.e. A: or B: or C:
Path must be in Valid Dos syntax, i.e. \dos\ or \wp50\letters\
Filenames may contain Wildcards, i.e. *.ZIP or H?.WP
Options must be proceeded by either / or -
1.10.2 Display Options
/? Display Help Screen
/W Wide Format, date,time and file size. Zip comment is
displayed on next line.
/NP No Pause
/NS No Save and Restore Screen
/EGA Display 43/50 lines
1.10.3 Color Options
/ZF=#,# ZIP filename Colors
/ZC=#,# ZIP Comment Colors
/OF=#,# Other Filename Colors
/TC=#,# Text Colors
#,#=foreground(0 to 15),background(0 to 7), No Spaces Allowed.
0 black
1 blue
2 green
3 cyan
4 red
5 magenta
6 brown
7 white
8 grey
9 light blue
10 light green
11 light cyan
12 light red
13 light magenta
14 yellow
15 bright white
---------------------------------------------------------------------------
ZCE & ZD Users' Manual 1.10 - Using ZD <Zip Directory>
Page 10 ZCE & ZD Users' Manual
---------------------------------------------------------------------------
1.10.4 Sorting Options
/SF Sort by Filename
/SS Sort by Size
/SE Sort by Extension
/SD Sort by Date
1.10.5 Pause Control Options
B backup listing
N re-read disk
Escape Quit ZD
1.10.6 Command Line Examples
ZD /?
Display help screen
ZD /w /sf
Display in wide format and sort by filename
ZD *.zip /ega /ss /zc=7,1 /np
Display all files with .zip extension, in 43 or 50 line mode, sort
by file size, show zip comments in white on blue and do not pause.
---------------------------------------------------------------------------
1.10 - Using ZD <Zip Directory> ZCE & ZD Users' Manual
1.11 - ZCE and ZD Registration Form Page 11
---------------------------------------------------------------------------
1.11 ZCE and ZD Registration Form
Zip Comment Editor & Zip Directory Version 1.0 REGISTRATION FORM
----------------------------------------------------------------
Name: _________________________________________________________________
Address: ______________________________________________________________
_______________________________________________________________________
_______________________________________________________________________
Phone: _______________________
_______ Registration(s) of ZCE and ZD @10.00 for both _________________
Total: ________________________
Type of PC Used: ______________________________ DOS Version: __________
Hardware Configuration: _______________________________________________
What Resident Software Do You Run: ____________________________________
_______________________________________________________________________
_______________________________________________________________________
Comments and Suggestions: _____________________________________________
_______________________________________________________________________
_______________________________________________________________________
_______________________________________________________________________
_______________________________________________________________________
Check or money order should be made payable to:
Michael D. Boling
974 Mission Ridge Drive
Manteca, CA 95336
The latest versions of ZCE and ZD will be sent without trailing
banners. Messages may be left on the Vanguard BBS (408) 988-0288.
---------------------------------------------------------------------------
ZCE & ZD Users' Manual 1.11 - ZCE and ZD Registration Form
Page 12 ZCE & ZD Users' Manual
---------------------------------------------------------------------------
1.12 ACKNOWLEDGEMENTS
Special Thanks to Phil Katz of PKWARE for releasing the zip file
formats. Without this many utilities like ZCE and ZD could not be
possible.
QuickBasic Libraries used to create ZCE and ZD
---------------------------------------------
PBCLONE (Pro Bas Clone) by Thomas G. Hanlin III
3544 E. Southern Ave. #104
Mesa, AZ 85204
MicroHelp ToolBox, QB/Pro Volumes 1-4 and Mach 2
4636 Huntridge Drive
Rosewell, Georgia 30075
(404) 552-0565
QB4BAS Version 4.6 by Harold Thomson
7437 Burnway Drive
Orlando, Florida 32819
(407) 351-3737
Quick Windows Shareware version 1.2 by Software Interphase Inc.
5 Bradley Street
Providence, RI 02908-2304
(401) 274-5465
Basic Window Tools Version 8.0 by James P. Morgan
5226 Via Hacienda #115
Orlando, Florida 32809
All libraries listed above are available to all registered users
from the Vanguard BBS, (408) 988-0288.
1.13 Future Versions
EGA/VGA 43/50 line support
Color Configuration
Longer Comment Editing
Improved Documentation
Other archive types
tag files for comment import
Please send comments and enhancement suggestions!!!!
---------------------------------------------------------------------------
1.13 - Future Versions ZCE & ZD Users' Manual